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CHAPTER 1 
INTRODUCTION 



1 . 1 GENERAL 

SUPEREDIT is an extremely versatile and powerful ASCII text 
w^^ww^ ^j-v,v,j.^j.v^aa.j.jf v^esj-gncia j.<j1 usfc; uii udta (aenerax computers 
running under an RDOS system. 

Some of the major features of SUPEREDIT are: 

• Multi-buffer editing 

• Multiple I/O files 

• Macro programming 

• Numeric variables 

It is assumed that the user is on line with an operating 
RDOS system. The system is described in the following 
document: 

093-000075 RDOS Real Time Disk Operating 

System User's Manual 

1.2 DOCUMENTATION CONVENTIONS 

1.2.1 Underlining 

Where clarification is required in the examples used in 
this manual, underlined copy denotes entries output by 
SUPEREDIT. Copy not underlined indicates user input. 

1.2.2 Control Characters 

Control characters such as CTRL-A are typed by holding down 
the CTRL key and pressing the letter A. Control characters, 
such as CTRL-A are represented in this manual and echoed by 
SUPEREDIT as fA. 
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1.2.3 Symbols 



The symbols listed in Table 1-1 are used throughout this 
manual for clarity. 

Table 1-1. Special Symbols 



Symbol 



H 

H 

{} 



Character 
Represented 



Carriage Return 



ESCape or 
ALTmode 



Space 



Character 
Pointer (CP) 



Tab 



Broken Brackets 



Braces 



Explanation 



Pressing the RETURN key 
generates an automatic line 
feed in addition to the 
carriage return. 

Th€is,dollar sign ($) is 
echoed on the terminal as a 
result of pressing the ESC 
or ALT key on your terminal 

Sometimes used in this 
manual to emphasize a 
space character. 

Used to represent the posi- 
tion of the Character 
Pointer. Also used in con- 
trol character (e.g., +A) 
representation. 

Represents use of the TAB 
or -M character on the 
terminal. 

Enclose optional arguments 
to a command . 

Indicate a choice of 
items enclosed. 
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1.2.4 Terminals 

The use of the word "terminal" throughout this manual implies 
a teletypewriter, CRT, or an equivalent interactive device. 

1.3 RUNNING SUPEREDIT 

SUPEREDIT is initialized for ECLIPSE'^"* line computers by 
typing 

speed) 

or 

SPEED filename ) 

J. (the exclamation mark is 

the SUPEREDIT prompt.) 

If "filename" exists, a UYfilename$ command is executed (see 
paragraph 3.1.3). If "filename" does not exist, a GWfile- 
name$ command is executed (see paragraph 3.1.1) and the 
message CREATING NEW FILE is typed out. 

For NOVA® * line computers type 

NSPEED ) 

or 

NSPEED filename ) 



*ECLIPSE is a trademark, and NOVA is a registered trademark 
of Data General Corporation, Southboro, Massachusetts. 
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CHAPTER 2 
CONCEPTS 



2.1 DATA FILES 

The ASCII user input files referred to in this manual are 
those which have been created on an RDOS system. As such 
the generalization "filename" used to indicate a user file 
is more specifically defined as follows: 

fprimary partition:} {secondary partition:} fsub-directory :} f J 
filename {.extension} 

For example: 

DPI: MYDIR : FILEl.LS 



P 



t t 

I extension 



filename 
secondary partition 
irimary partition 



2 . 2 DATA FORMAT 

An ASCII input file contains a string of ASCII characters. 
Characters form lines v/hich are terminated by a carriage 
return {)) . A string of characters up to, but not including, 
a form feed character is defined as a page. Files may be 
divided into pages or windows containing a fixed number 
of lines . 



2.3 EDIT BUFFERS 

SUPEREDIT provides 36 Edit Buffers which may be used for 
editing user files. Commands are available for transferring 
data from input files to any buffer, transferring data 
from one buffer to another and for outputting from buffers 
to output files. Buffers may contain textual data, commands 
to be executed, or both. 
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2.3 EDIT BUFFERS (Continued) 

Buffers have single character names (A to Z and to 9) , and 
only one buffer is the current buffer at any given time. 
Initially, buffer is the current edit buffer. Any edit 
buffer referenced during an editing session is considered 
to be active. 

A detailed explanation of buffer commands is provided in 
section 3.11. 



2.4 THE EDITING PROCESS 

The editing process consists of the following steps: 

1. Read text from an input file to an edit buffer 
or type in text for a new file. 

2. Modify the text in the edit buffer. 

3. Write the contents of the edit buffer to an 
output file. 

Step 3, above, is extremely important. The output commands 
described in section 3.9 must be used to insure preservation 
of edited material. 

2.5 CHARACTER SET 

The character set used by SUPEREDIT is the full ASCII char- 
acter set in Appendix A. Both the octal and decimal values 
of the characters are given and should be referenced when 
using the nl variation of the Insert (I) command discussed 
in section 3.7. 

2.6 CHARACTER POINTER (CP) 

The Character Pointer (CP) is the mechanism used by SUPEREDIT 
to keep track of the current position within an edit buffer. 
The CP may be located at the beginning of an edit buffer, 
between two characters in the buffer, or at the end of the 
buffer. The symbol "f" is used in some examples to show the 
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2.6 CHARACTER POINTER (CP) (Continued) 

position of the CP . Character Pointer Commands described in 
Chapter 3 are used to reposition the CP to any location 
withman edit buffer. Most modification commands will alter 
the edit buffer at the CP position. An insert (I) command 
for example, will insert a text string at the position of 
the CP. The effect of a command on the CP is described with 

— — »-*- J-- w w fc,_t V w »»^vjilliuciii\_t • 
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INTERPRETATION OF LINE-ORIENTED COMI^IAND ARGUMENTS 



SUPEREDIT considers a line as a string of characters ending 
with a carriage return. For those commands which are line- 
oriented (e.g., K and L) SUPEREDIT treats the numeric 
argument of these commands in the following manner. 



THIS IS LINE 1 

I 1 

THIS IS LINE 2 



THIS IS(f) LINE 3 

i ! 1 i 

THIS IS LINE 4 

I- — 1 



In the above illustration the CP is located in the middle of 
line 3. The command -2K kills lines 1, 2 and the characters 
-.J- WW w^ic ^r- j.ii a.xjifc _i . j.nc iwOmmanct ^i\ js.ixxs tne cnaxcic'cers 
in line 3 starting from the CP plus the entire line 4. A OK 
command kills the characters from the beginning of line 3 up 
to the CP. A IK command kills the characters starting from 
the CP up to the end of line 3. A -IK command kills line 2 
and the characters up to the CP in line 3. 

2 . 8 COMMAND STRUCTURE 

The commands used in SUPEREDIT are of the general form: 

T{m?n/f f modifiers} code [string} $ 

or 
{modifiers} 4|j^"^U code fstring}$ 
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2,8 C0r4MAND STRUCTURE (Continued) 

where: n is an optional numeric argument which may pre- 
cede certain commands. 

m,n is an optional double argument allowable on 
certain commands. 

modifiers may be used to alter the normal operation 
of the command. 

code is the character or characters which repre- 
sent a SUPEREDIT command. Code may be either 
upper case or lower case characters. 
string is a character string argument required 
by certain commands. 

$^ is an ESCape character which terminates a single 
command. 

A command string consists of one or more concatenated com- 
mands. The last command in the string is always terminated 
by a double ESC ($$) which signals SUPEREDIT to begin proc- 
essing the command. 

l"{m"n}-- code tstring}$|\in'^n /J c°^^ fstring}$ . . . $$ 

Example : 

Assume the current line is 

SOMEONEANEEDED 

f 

the command string 

j_-3D$IAHELP$T$$ 

would delete ONE, insert AHELP and type the line including 
the current position of the CP shown as "(t)". 

SOr-lE HELP ( t ) NEEDED 

Commands which never require string arguments following the 
command code (e.g., L,T,D) do not require an ESC ($) to 
delimit the command within a command string. 

Example: 

j_3DL2TITEXT$T$$ is equivalent to 

_;_3D$L$2T$ITEXT$T$$ 
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2.9 COMMAND ARGUMENTS AND MODIFIERS 

There are two categories of command arguments: Alpha- 
numeric arguments which follow commands and numeric argu- 
ments which always precede commands. 



2.9.1 Alphanumeric Arguments 

Alphanumeric arguments are the character string arguments 
which follow such commands as Insert (I) or Search (S) . 






_;_IJUNE$S1974$$ 



Both "JUNE" and "1974" are 
alphanumeric arguments to 
the commands I and S respec- 
tively. 



An ESC ($) must always be used to terminate an alphanumeric 
argument and thereby delimit the argument from the next 
command in the command string. 

2.9.2 Numeric Arguments 

Numeric arguments which precede commands are always evaluated 
to^a decimal integer value before the command is executed. 
A_ numeric argument may be an expression, may contain any 
digit, the numeric operators described in Table 2-1, 
numeric variables as described in section 3.14 and special 
characters that represent numeric values as described in 
paragraph 2.9.4. 



Table 2-1. Numeric Operators 


Operator 


Function 


+ 


Addition 


- 


Subtraction 


* 


Multiplication 


/ 


Division 



2-5 



2.9.2 Numeric Arguments (Continued) 

Evaluation of numeric arguments which contain numeric oper- 
ators is performed from left to right. 

Single numeric arguments are represented in this manual by 
n and double arguments by m,n . The double argument must 
always be separated by a comma and m must always be less 
than or equal to n. Generally, if the numeric argument (n) 
is omitted from a command, n is assumed to be 0. 



Example : 



13+1,60T$$ Type out the 5th through 60th 

"" characters in the buffer. 



Numeric arguments may be positive or negative and are 
interpreted as a value in the range of -32768 to +32767 
v;ith the following exceptions: 

a) Double argument commands (m,n) 

b) \ 

c) J 

d) = 

which are interpreted as being in the range to +65535. 



2.9.3 Numeric Variables 

There are 10 numeric integer variables (named to 9) . Each 
of the 10 variables is initially set to 0. The variables 
can be individually set to a value, incremented or decremented 
They can be used as numeric arguments to commands, alone, 
or in argument expressions. Numeric variable commands are 
described in section 3.14. 



2.9.4 Special Character Numeric Arguments 

These special characters stand for specific values associated 
with the Character Pointer (CP) , the size of the text buffer 
or lines in the current buffer. The special characters are 
described in Table 2-2 and can be used as numeric arguments. 
Alphabetic characters can be either upper case or lower case. 



2-6 



2.9.4 Special Character Numeric Arguments (Continued) 



Table 2-2. Special Character Numeric Arguments 



O^erat'^r 



(period) 



VL 



VN 



i-le a n 1 n y 



Represents the CP position 
immediately following the last 
character in the buffer. This 
is equivalent to the total num- 
ber of characters in the buffer, 

Represents current CP position. 
This is equivalent to the 
number of characters between 
the beginning of the buffer 
and the character to the left 
of the CP. 

A special double argument 
which is equivalent to 0,Z 
(the entire buffer) . 

Represents the number of the 
line which contains the CP . 

Represents the number of lines 
in the current buffer. 



Example : 



16VS0$. , .+VIOT$$ 



Type out the 7 characters 
following the CP . This 
command uses numeric 
variable commands described 
in section 3.14. 
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2.9.5 Command Modifiers 

Several command modifiers ((? and :) are used with various 
commands to extend the versatility of the commands by 
altering their normal interpretation. The command modifiers 
must precede the command code in the command string. The 
command modifiers are described in detail in paragraph 3.16.2, 



2.10 MODES OF OPERATION 



2.10.1 Input Mode 

When SUPEREDIT outputs a prompt (1) to the terminal, SUPER- 
EDIT is ready to accept a command string which must be 
terminated by a double ESC ($$). Command strings may be 
typed on more than one line. 



2.10.2 Execution Mode 

When SUPEREDIT recognizes a double ESC ($$) it outputs 
a carriage return and begins execution of the commands in 
the command string. When SUPEREDIT finishes execution of the 
commands in a command string it outputs another prompt ( '. ) 
indicating that the user may enter additional commands. 



2.11 DATA INPUT MODES 

SUPEREDIT has the facility to input file data by pages 
(form, feed- to- form, feed) or when in Window Mode by a set 
number of input lines. The comjnands which control Page 
and Window Mode operation are described in section 3.2. 



2.12 CORRECTING COMMJ^ND STRINGS 



2.12.1 Erasing Characters and Lines 

The RUBOUT key is used to delete erroneously typed char- 
acters from a SUPEREDIT command string. Each time the 
RUBOUT key is pressed, the right most character is deleted. 
When a character is deleted it is echoed on the terminal. 
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2.12.1 Erasing Characters and Lines (Continued) 
For example: 

_^IHELLOOLLEHBYE$$ The user pressed RUBOUT once 

for each character in the 
v7ord HELLO. 

A single line may be deleted by typeing CTRL-X (fX) and is 
equivalent to typing RUBOUT back to the beginning of the 
line. The line may not be recovered. A -fX at the beginning 
of a line deletes the previous line. 

Example : 

J^HELLO +X is equivalent to the 

j_IBYE$$ previous example. 

2.12.2 Aborting Command Strings 

In Input Mode, an entire command string (on one or more 
lines) may be aborted by typing CTRL-A (fA) . SUPEREDIT 
will return the user to the prompt condition. If fA is 
inadvertently typed, the command string may be recovered 
by a -^-n command (see paragraph 3.16.1) since SUPEREDIT 
always saves the last command string. 

Example: 

_;_ITEXT$ 

IMORETEXT$ 

ILOTSMORE TEXT +A fA eliminates all three lines 

i. of the command string. 

In execution mode, typing a +A will terminate execution 

of the command string and return SUPEREDIT to the Input Mode. 

2.12.3 Verification Of Command Lines 

A CTRL-R (1-R) can be used to immediately retype the last line 
of a command string for verification. This is useful for 
those lines which have been corrected by excessive use of 
RUBOUT and are difficult to read. 
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CHAPTER 3 
SUPEREDIT COMMANDS 



The commands described in this chapter provide the facility 
for editing, splitting, rearranging and merging files. 
Sections 3.1 through 3.10 describe the fundamental commands 
required for most editing sessions. Section 3.11 through 
3.17 describe commands for the advanced user. 

Occassionally the user may precipitate an error message due 
to incorrect command usage. Refer to section 4.2 for a 
complete explanation of error handling. 

3.1 FILE SPECIFICATION COMMANDS 

Files are considered to be either global or local. A global 
file IS applicable to all 36 edit buffers while a local 
file is only active for one particular edit buffer. Local 
files take precedence over global files. Therefore, any 
command which accesses a file (e.g.. File Input, N and Q 
Search, Output) will apply to an open local file if one 
exists. Otherwise it will apply to an open global file. 

Note: "Filenames" shown in command formats may include 
extensions . 



3.1.1 The GW Command 

The GW (Get for Writing) command is used specifically for 
creating a new file. The general form of the command is: 

_^GWfilename$$ 

The "filename" specified in the command must not already 
exist. A sequential file named "filename" is opened for 
output. Only one global output file may be opened at one 
time. If another file is already opened for output it 
must be closed before a new GW command is specified 
and executed . 
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3.1.1 The GW Coiranand (Continued) 

Text which is inserted into edit buffers is subsequently 
copied to the "filename" specified in the GW command by 
appropriate output and file closing commands. 

Another form of the GW command is: 

J^ : GWf i lename $ $ 

This command is essentially the same as the GWfilename$$ 
command except that a random file is created and opened 
for output rather than a sequential file. 



3.1.2 The GC Command 

This command is of the form: 
^GC$$ 

The command closes the current output file as is. It does 
not provide for writing from any edit buffer or input file 
before closing the output file. 

3.1.3 The UY Command 

This command opens an existing file for input, yanks a page 
from the input file into an edit buffer and creates a new 
file for output with the extension .SC. 

The command is of the form: 

•.UYfilename$$ 



Example: 



1UYTEST.EX$$ 



Open TEST. EX for input 
Open TEST.SC for output 
Y (Yank) a page 



The "filename" specified for input in the UY command may 
not have a .SC extension. If the input "filename" is 
sequentially or contiguously organized then the new output 
file will be sequentially organized. If the input "filename" 
is randomly organized then the new output file will be ran- 
domly organized. Only one global input file may be opened 
at one time. 
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3.1.4 The GR Command 

This command closes the currently open input file and opens 
for input the "filename" specified in the command. 

The form of this command is: 

_l_GR f i 1 ename $ $ 

After the specified file is opened, a Yank (Y) or Append (A) 
command (see section 3.3) must be used to insert a page into 
the edit buffer. This does not occur automatically as in 
the UY command. 

Another form of the GR command is : 

_;_GR$$ 

This command closes the currently opened input file without 
opening another file. 

3.1,5 The US Command 

The US command is used to copy the content of the current 
buffer and the remainder of the input file to the output 
file (an E command) and then close both the input and output 
files. The current buffer is left cleared. The form of 
this command is: 

_;_us$$ 

If the input and output files were opened by a UY command 
then the input file is renamed to filename. BU and the output 
file is renamed from filename. SC to the orginal filename of 
the input file. The result is a backup file of the original 
input file and a new edited file with the original filename. 
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3.1.5 The US Coimnand (Continued) 
Example : 

:UYSAMPLE.JK$$ 



Open input file SAMPLE. JK 
Open output file SAMPLE. SC 

Edit comrnands 



1US$$ 



Copy current buffer and rest 

of SAMPLE. JK to SAMPLE. SC 

Close SAMPLE. JK 

Close SAMPLE. SC 

Rename SAMPLE. JK to SAMPLE. BU 

Rename SAMPLE . SC to SAMPLE. JK 



3.1.6 The UE Command 

The UE command is used to copy the content of the current 
buffer and the remainder of the input file to the output 
file (an E command) and close the input and output files. 

If the input and output files were opened by a UY command 
then the input file is deleted, and the output file is 
renamed to the name of the original input file. The cur- 
rent buffer is left cleared. 

The form of this command is: 



Example 



:uE$$ 



lUYSAMPLE.JK 



'.UE$$ 



Open input file SAT^IPLE.JK 
Open output file SAMPLE. SC 

Edit Comm.ands 

Copy current buffer and rest 

of SAMPLE. JK to SAI-IPLE.SC 

Close SAMPLE.JK 

Close SAMPLE. SC 

Delete SATIPLE.JK 

Rename SAMPLE. SC to SAMPLE.JK 
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3.1.7 THE U? Command 

The U? command is the file status command. It provides a 
list of open global and local input and output files. The 
local files are those relevant to the current edit buffer. 
The form of the command is: 



Example; 



'.U?$$ 



_;_UYSAr4PLE . JK$U?$$ 
GLOBAL : 



LOCAL : 



INPUT FILE - SAMPLE. JK 
OUTPUT FILE - SAJ^^PLE.SC 

INPUT FILE - NONE 
OUTPUT FILE - NONE 



3 . 2 DATA INPUT MODE COMMANDS 

Data is read from an input file to the current edit buffer 
in either page lengths (form feed-to-form feed) or in 
window lengths (fixed number of lines). Initially SUPEREDIT 
is in Page Mode and any File Input command (e.g., Y) causes 
page lengths to be input. The commands described in Table 3-1 
permit switching from one data input mode to the other. 

Table 3-1. Page and Window Mode Commands 



Command 



WM 



nWM 



o\m 



Description 



Returns value of data input mode. If 
WM^^O, SUPEREDIT is in Page Mode. If 
WM=n (where n>0) SUPEREDIT is in Window 
Mode and n is number of lines per window. 

Changes input from Page Mode to Window 
Mode with a window length of n lines. 
SUPEREDIT is initialized in Page Mode. 

Changes input from Window Mode to Page Mode. 
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3.2 DATA INPUT MODE COi'^LMANDS (Continued) 

Data read from an input file in Windov/ Mode will include 
any form feed characters embedded in the file exactly as 
they are encountered. In Page Mode SUPEREDIT remembers 
when the last character read by an input command was a form 
feed but does not place the form feed character into the 
edit buffer. The detection of the form feed character 
on input is pertinent to the R, nR and E output commands 
discussed in section 3.10. 



3.3 FILE INPUT COP'U^IANDS 

The commands described in Table 3-2 read data from an input 
file into the current edit buffer. Data is read in either 
as pages or v/indov/ lengths depending on the current data 
input mode (Page or Window) . 

Table 3-2. File Input Commands 



Command 



A 



;Y and :A 



Description 



The Yank command. The current edit buffer 
is cleared, then a page or window length 
of the input file is read into the buffer. 
The CP is positioned at the beginning of 
the buffer. 

Appends a page or window length from the 
input file to the current edit buffer. 
The CP position is unchanged. 

Essentially same as Y and A, respectively, 
except returns a command value of +1 if 
Yank or Append was successful and if 
the command failed. No error message 
is output. Both :Y and :A may be used 
as numeric arguments to the next com- 
mand. For example: 

1:Y*10T$$ If Yank is successful 
~ type 10 lines . 
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3.4 TEXT TYPE-OUT C0MI4ANDS 

Text Type-Out cominands (described in Table 3-3) may be used 
to examine part or all of the current buffer. 

When used with a single numeric argument, the T command is 
line-orienten . Whon usei^ w-i t-v< a nq-i>- ^-f v^htt^qv--; ^ -.^^, ,„„_■!-- 
(m,n), the T command is character oriented. 

NOTE 

The Text Type-Out cominands do not move the CP . 

Table 3-3. Text Type-Out Commands 



Command 



OT 



nT 



-nT 



m,nT 



:0T 
:nT 
:-nT 
:m,nT 



Description 



Types the content of the entire current line 
(line containing the CP) and includes the 
character "(+)" at the current location 
of the CP. 

Types current line from beginning to loca- 
tion of the CP. 

Types the content of the current buffer from 
the location of the CP through the next n 
carriage returns. 

Types the content of the n lines preceding 
the current line plus the content of the 
current line up to the CP. 

Types the content of the current buffer from 
the m+lth character up to and including 
the nth character. 

Forms of T commands modified 
by colon (:) print output 
on line printer rather than 
on terminal. 
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3.5 CHARACTER POINTER (CP) COMMANDS 

The Character Pointer (CP) commands described in Table 3-4 
may be used to move the CP between any two characters in 
the current edit buffer. The CP may be moved forward or 
backward, by characters or by lines. The CP is the means of 
specifying within an edit buffer the position at which 
insertions, deletions or corrections are to be made. 

Table 3-4. Character Pointer (CP) Commands 



Command 



Description 



nJ 



J, OJ 
or IJ 

nL 



-nL 



L or 
OL 

nM 



Move the CP to the beginning of line n in 
the current buffer. n is always relative 
to the beginning of the current buffer. 
Line 1 is the first line of the buffer. 

Move the CP to the beginning of the first 
line in the buffer. 

Move the CP forward across n carriage 
returns and position the CP at the beginning 
of the line following the nth carriage 
return. 

Move the CP backward to the beginning of 
the nth line preceding the current line. 

Move the CP to the beginning of the current 
line . 

This command moves the CP n characters to 
the right or left. If n>0 the CP is moved 
n characters to the right. If n<0 the CP 
is moved n characters to the left. 
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3.6 SEARCH COMIANDS AND CONTROL CHARACTERS IN SEARCHES 



3.6.1 Search Conunands 

Search commands (see Table 3-5) are used to reposition the 
CP by means of a character string search. The Search com- 
mands cause SUPEREDIT to scan through the text until a 
specified string of characters is found, and then positions 
the CP after the last character in the string unless a fP 
is inserted into the search string. If the end of the 
edit buffer is reached during a S or C command and the 
search is not successful, an error message is printed on 
the terminal and the CP is repositioned at the beginning of 
the buffer. For N and Q searches an unsuccessful search 
will result in the entire file being read and the buffer 
being left empty. Text strings being searched for may not 
overlap page or window boundaries. 

Table 3-5. Search Commands 



Command 


Description 


Stext$ 

nStext$ 
-nStext$ 


Searches the current buffer from 
position of CP for string "text". If 
string is found, CP is positioned after 
the last character in the string. I J 
not found, CP is positioned before the 
first character in the buffer and an 
error message is printed. 

Similar to the S command except search 
is from CP through next n carriage 
returns. The CP is left at the begin- 
ning of the line after the last line 
searched if search is unsuccessful. 

Similar to S command except search 
starts from beginning of nth line 
preceding the current line and ends at 
the current position of the CP . If the 
search fails, the CP is located at its 
original positions and an error mes- 
sage is printed. 
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3.6.1 Search Commands (Continued) 

Table 3-5. Search Commands (Continued) 



Command 



Description 



OStext$ 



m,nStext$ 



Ctextl$text2$ 



nCtextl$text2$ 



-nCtextl$text2$ 



Searches for string "text" from the be- 
qinning of the current line to the posi 
tion of the CP. If the string is found, 
CP is positioned after the last char- 
acter in the string. If not found, the 
CP is located at its original position 
and an error message is printed. 

Searches the m+lth through nth char- 
acters of the buffer inclusive for 
string "text". If string is found, 
CP is positioned after the last char- 
acter in string. If not found, CP 
is positioned after the nth character 
and an error message is printed. 

The C (Change) command is a combination 
search and modify command. A search 
is conducted from the CP position for 
"textl". If found, "textl" is deleted 
and "text2" is inserted in its place. 
The CP is positioned after the last 
character of "text2". If "textl" is 
not found in current buffer, an error 
message is printed and the CP is 
positioned at the beginning of the 
buffer. 

Same as Ctextl$text2$ except search is 
from CP through next n carriage re- 
turns. The CP is positioned at the 
beginning of the line after the last 
line searched if search is unsuccessful. 

Similar to the Ctextl$text2$ command 
except the search starts from the 
beginning of the nth line preceding the 
current line and ends at the position 
of the CP. If the search fails, the CP 
is located at its original postion and 
an error message is printed. 
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3.6.1 Search Commands (Continued) 

Table 3-5. Search Commands (Continued) 



Command 



0Ctextl$text2$ 



m,nCtextl$text2$ 



Ntext$ 



Qtext$ 



Description 



Searches for "textl" from beginning of 
current line to the position of the CP . 
If found, "textl" is deleted and 
"text2" is inser"*"ed i*^ its ^'^ ac^ Th^ 
CP is positioned after the last char- 
acter of "text2". If "textl" is not 
found, the CP is located at its 
original position and an error mes- 
sage is printed. 

A search is conducted from the m+lth 
through nth characters of the buffer 
for "textl". If found, "textl" is 
deleted and "text2" is inserted in 
its place. The CP is positioned after 
the last character of "text2". If 
"textl" is not found an error mes- 
sage is printed and the CP is 
positioned after the nth character. 

Performs same function as Stext$ 
command except search continues across 
page boundaries if necessary until the 
end of the input file is reached. The 
search begins at the CP position in 
the current buffer. If the end of 
the buffer is reached an R command is 
executed and the search continues until 
the string is located or an end-of- 
file is reached. If the search is not 
successful, an error message is 
printed . 

Similar to an N command except a Y 
command is executed rather than an R 
command, if the string is not found in 
the current buffer. No output is done 
to the output file. 
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3.6.1 Search Commands (Continued) 

Table 3-5. Search Commands (Continued) 



Comm.and 


Description 


@S%text% 
:Stext$ 


Same as Stext$ except the text is 
delimited by the first character after 
S (arbitrarily shown as %) . The @ 
modifier changes the command termina- 
tor from ESC($) to any other char- 
acter (e.g., %) and may be used with 
any S, N, C or Q command. 

Same as Stext$ except the command 
returns a value of +1 if it succeeds 
and if it fails. No error message 
is output if search is unsuccessful. 
The command can be used as a numeric 
argument to the next command. The 
colon (:) modifier may be used with 
any S, N, C or Q command. 

The command modifiers may also be 
combined. For example, the following 
command strings are legal. 

@:S%text% 
:@C%textl%text2% 



3.6.2 Control Characters In Searches 

SUPEREDIT executes a search command by attempting to match 
the search command argument character-for-character with 
some portion of the current buffer. Several control char- 
acters are available for altering the normal search process 
and are described in Table 3-6. 
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3.6.2 Control Characters In Searches (Continued) 

Table 3-6. Control Characters In Searches 



Command 


Description 


A f7 
1 £J 






search command string it is an indication 




that the position occupied by fZ is un- 




important and any character is an acceptable 




match i. 




For example: 




ABCDE matches ABfZDE 


fNx 


Any character in the position occupied by 




fNx is acceptable except for the character x. 




For example: 




ABCDE matches ABC+NEE 




ABCDE does not match ABCINDE 


fVx 


A fVx in a search string indicates that any 




num.ber of the character x (including 0) is 




an acceptable match. 




For example: 




ABCE and 




ABCDE and 




ABCDDDE are acceptable matches to 




ABCfVDE 


j-^ 


This control character causes the char- 




acter following i^- to be interpreted literal- 




ly rather than as a special character. 




This control character is useful when 




conducting a search for other control char- 




acters (e.g., +Z, IN, etc.) 
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3.6.2 Control Characters In Searches (Continued) 

Table 3-6. Control Characters In Searches (Continued) 



Command 



tT 



Description 



+P in i search string is a character pointer 
(CP) positioning character. If the search 
is successful, the CP will be positioned 
where tlie -t-P was in the search string, 
instead of at the end of the matching string, 

For example: 

J_Stextl + PAtext2$T$$ 
textl (i) Atext2I 

This control character matches any number 
of spaces, or TAB (including 0). 



For example: 



ABCAAADE 
ABCADE 
ABC HdE 
ABCDE 

ABC+TDE 



and 

and 

and 

are all acceptable matches 

for 



NOTE 

Any other control character (except TAB (tl), CR (+M) , FF (+L) , 
VT (fK), tG, LF (iJ), -^B) in a search string is flagged as 
an error unless precede^ by a ■ -^ ccuitrol character. 
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3.7 INSERTION COMMANDS 

All insertion commands described in Table 3-7 cause a string 
of characters, specified in the command, to be inserted into 
the current buffer at the position of the CP. The CP is 
then repositioned to follow the last character of the 
insertion. 



Table 3-7. 



Insertion Commands 



Command 



Itext$ 



-Mtext$ 



nl 



n\ 



@I%text% 
(a-M%text% 



Description 



The string specified by "text" is inserted 
into the current buffer at the position of 
the CP and the CP is repositioned to follow 
the last character of the insertion. 

This command is similar to I command except 
that a TAB {-\ ) is inserted into the edit 
buffer before the text string. The command 
is equivalent to I-»|text$. 

A special form of the I command, it allows 
insertion of a single character, where n 
is the decimal equivalent of any ASCII char- 
acter given in Appendix A. The command is 
particularly useful for inserting char- 
acters which may not be available on the 
input terminal. It is the only way to 
insert the characters fB(2I) and +G(7I). 

Inserts the ASCII representation of the 
decimal number n into the buffer at the CP 
location. Leading zeroes are suppressed. 

Same as Itext$ and tItextS except that the 
text is delimited by the first character 
after I (arbitrarily shown as %) . The (3 
modifier changes the command terminator from 
ESC ($) to any other character (e.g., %) . 
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3.8 DELETION COMMANDS 

The commands described in Table 3-8 are used to delete char- 
acters and lines from an edit buffer. 



Table 3-8 



Deletion Cominands 



Command 


Description 


nK 

-nK 

K or OK 
m,nK 

nD 


Deletes characters in the current buffer 
from the CP up to and including the next n 
carriage returns. 

Deletes the n lines preceding the current 
line plus the characters up to the CP in 
the current line. 

Deletes the characters from the CP back to 
the beginning of the line containing the CP. 

Deletes the m+lth through nth characters 
inclusive from the current buffer. The CP 
is positioned after the mth character. 

Deletes characters from the current buffer. 
If n is positive, deletes the n characters 
following the CP . If n is negative, deletes 
the n characters preceding the CP. 



3.9 OUTPUT COMMANDS 

The commands listed in Table 3-9 permit the user to output 
data from edit buffers and input files to output files. 

NOTE 

The P and PW cominands do not clear the buffer after 
output unless modified by the colon {:) modifier. 
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3.9 OUTPUT COMMANDS (Continued) 

Table 3-9. Output Commands 



Commands 



nP 



-nP 



OP 



m,nP 



PW 



nPW 



-nPW 



Description 



Outputs the entire contents of the current 
buffer to the output file with an appended 
form feed character. The CP does not move. 

Outputs n lines from the position of the CP 
in current buffer to the output file with 
an appended form feed character. The CP 
does not move . 

Outputs the preceding n lines plus the 
characters up to the location of the CP in 
the current line to the output file with an 
appended form feed character. The CP does 
not move . 

Outputs the characters on the current line, 
from the beginning of the line to the 
location of the CP, to the output file with 
an appended form feed character. The CP 
does not m.ove . 

Outputs the m+lth to nth characters inclusive 
from the current buffer to the output file 
with an appended form feed character. The 
CP does not move. 

Outputs the entire contents of the current 
buffer to the output file without appending 
a form feed. The CP does not move. 

Outputs n lines from the position of CP in 
the current buffer to the output file with- 
out appending a form feed. The CP does 
not move . 

Outputs the preceding n lines plus the char- 
acters up to the location of the CP in the 
current line to the output file without 
appending a form feed. The CP does not move. 
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3.9 OUTPUT CO^U^NDS (Continued) 

Table 3-9. Output Commands (Continued) 



Command 



Description 



OPW 



m , nPW 



:P 



R 



nR 

R and :nR 



Outputs the characters on the current line, 
from the beginning of the line to the 
location of the CP , to the output file 
without appending a form feed character. 
The CP does not move. 

Outputs the m+lth to nth characters inclusive 
from the current buffer to the output file 
without appending a form feed. The CP 
does not move . 



Modified form of P command clears buffer 

colon (:) modifier may be used with all P 
command variations. 

Outputs the content of the current buffer, 
appends a form feed only if detected as 
last character read on the previous input 
(A or Y) to the buffer, clears the buffer 
and yanks another page or window length into 
the buffer. 

Performs an R command n times. 

Modified forms of R and nR commands return 
a value of +1 if input is successful and 
if it fails. No error message is output. 
The commands may be used as numeric argu- 
ments to the next command. 

Outputs the contents of the current buffer 
and the remainder of the input file to the 
output file. Any form feeds detected on 
input are copied to the output file. The 
current buffer is left cleared. 
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3.10 EXIT C0M4ANDS 

The commands described in Table 3-10 are used to ekit from 
SUPEREDIT. 

Table 3-10. Exit Commands 



Command 


Description 


J- -I 


Exit from SUPEREDIT and return to the CL.1 . 
SUPEREDIT closes all files before returning 
to CLI. This command is used to make an 
orderly exit from SUPEREDIT at the end of 
an editing session. 

A control character which interrupts SUPER- 
EDIT, creates a BREAK. SV file and returns 
the user to the CLI level. Should only be 
used as an emergency exit from. SUPEREDIT. 



^ 1 1 



XJ V^ J. J- J_|J.\. 



Buffer commands provide the flexibility for manipulating 
blocks of data which can be stored in any of the 36 edit 
buffers (0 to 9 and A to Z ) available in SUPEREDIT. One 
edit buffer is current at any time. Commands are available 
to open input and output files which apply only to a given 
edit buffer. These files are called local files. Files 
which do not specifically apply to a given buffer are called 
global files. Any commands which act on files (e.g., Y, 
P, etc.) will apply first to open local files. Therefore 
a local file must be closed before a global file can be 
used for a particular command. 

Buffer commands are described in Table 3-11. 
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3.11 BUFFER COMMANDS (Continued) 

Table 3-11. Buffer Commands 



Commands 



BSx 



R?<^ 



B?x 
BCx 



Description 



This command changes the current edit buf- 
fer to edit buffer x. x is a single char- 
acter name for any one of the 36 edit buf- 
fers (A to Z and to 9) . Only one edit 
buffer may be current at a time. The 
status of the CP position and of any open 
local files is saved when the current 
edit buffer is changed, and is restored 
for the new edit buffer. Comm.ands such 
as Yank (Y) and Append (A) input data from 
an input file to the current edit buffer. 

The buffer status command provides a list 
of all active buffers and their length 
(characters) and indicates which edit 
buffer is the current buffer with a right 
angle bracket (>) . 



For example: 

_;_B?$$ 

> 



BUFFER I 
BUFFER A 
BUFFER G 



36 

18749 

1902 



Buffer A is the current buffer. 

Types out status of buffer x. 

Copies the entire contents of the current 
buffer to buffer x after clearing buffer x. 
The content and CP position of the current 
buffer remain unchanged. Buffer x CP is 
positioned at the beginning of buffer x. 
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3.11 BUFFER COMMANDS (Continued) 

Table 3-11. Buffer Commands (Continued) 



Command 



nBCx 



-nBCx 



m,nBCx 



BTx 
nBTx 
-nBTx 
m,nBTx 

BKx 



Description 



Copies the next n lines starting from the 
present position of the CP in the current 
buffer to buffer x after clearing buffer x, 



For example: 



1BS3$5BCA$$ 



Copies 5 lines from 
buffer 3 to buffer A 
after clearing buffer 
A. The content and 
CP position of buffer 
3 remain unchanged. 
Buffer A CP is 
positioned at the 
beginning of buffer A. 



Copy the n lines preceding the current line 
plus the characters on the current line up 
to the CP to buffer x after clearing buf- 
fer X. The content and CP position of the 
current buffer remain unchanged. Buffer x 
CP is positioned at the beginning of buffer 

X. 

Copies the m+lth through nth characters 
inclusive from the current buffer to buf- 
fer X after clearing buffer x. The content 
and CP position of the current buffer 
remain unchanged. Buffer x CP is positioned 
at the beginning of buffer x- 

Same as BCx, nBCx, -nBCx and m,nBCx 
respectively except characters moved from 
current buffer are deleted (buffer 
transfer) . 

Inactivate buffer x. Buffer x may not 
be the current buffer. 
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3.11 BUFFER C0Mr4ANDS (Continued) 

Table 3-11. Buffer Commands (Continued) 



Command 



BGx ff ilename} $ 



BUx tf ilename} 



BAx 



Description 



Where Gx is OR, 
name specified 
local to the cu 
Only one local 
input and one 1 
for output for 
The U? command 
port of global 
files for the c 



GW or GC. The file- 
is opened or closed 
rrent edit buffer, 
file may be open for 
ocal file may be open 
each active buffer, 
provides a status re- 
and local input/output 
urrent buffer. 



Where Ux is UY, UE or US. The local 
input and output files are opened or 
closed in accordance with the re- 
spective UY, UE or US command. 

Activate buffer x_- All buffers ex- 
cept for the current buffer are 
stored on disk unless explicitly 
deleted by a BKx command. In the 
event of an error, it is possible 
to recover all the active buffers 
in a subsequent invocation of 
SUPEREDIT by use of the BAx com- 
mand for each buffer to be activated, 
The buffer status (i.e., content 
and CP position) is retained. How- 
ever local and global file status 
will be lost. 
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3.12 COMMAND STRING INSERTION COMMANDS 



The commands described in Table 3-12 are used to insert the 
contents of a file or edit buffer into the command string. 

Table 3-12. Command String Insertion Commands 



Command 



fRf 1 1 pn^TTif^S 



iBx 



Description 



***— -■-■•■'■•^-■-^^-•.K^i.i. v-zo. i_iij-o >^>jiiima.ina xil d UUllUltctna 

string will cause the contents of the file 
named "filename" to be inserted in the 
command string in place of the +Gfilename$ 
command. The file may contain text to be 
inserted, commands to be executed, or both. 
The file must be less than 16K bytes long. 

This command in a command string will cause 
the contents of buffer x to be inserted in 
the command string in place of the fBx 
command. Buffer x may contain text to be 
inserted, commands to be executed, or both. 
Buffer X cannot be the current buffer. 



The +Bx and fGfilename$ commands mav be nested up to 10 
levels deep. When the fBx or fGfilename$ commands are used 
^LJjr'^^f ?^^° ^^^5"^^ (section 3.6) or Insertion commands 
(section 3.7) the characters up to the first ESC ($) in 

l^t^t J"" ^'^ ^^^^ ^^^ treated literally as text characters 
rather than as commands. 



3.13 ITERATION COM-IANDS 



3.13.1 Construction 

A command string may be executed any number of times by 
placing the command string between angle brackets and specify- 
ing the number of iterations with a numeric argument pre- 
ceding the brackets. A command string within angle brackets 
IS called a command loop. The general form of a command 
loop is: 
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3.13.1 Construction (Continued) 

n < command string > 

If n< 0, the commands within the brackets are skipped. If 
n>0, the commands are repeated n_ times. If n is omitted, 
the commands are repeated indefinitely. 

For example: 

_l_:SDATEA$ <IJUNE$ > $$ Searches for DATEA and inserts 

JUNE if found; otherwise CP 
is repositioned to beginning 
of buffer. No error message 
if string is not found. If 
DATEA is found, value of 
rSDATEA is +1 and loop is 
iterated one time. If search 
fails :SDATEA is and loop 
is skipped. 

Nesting of command loops is permitted up to 10 levels deep. 

Search commands and File Input commands within command loops 
are treated as though they were modified by the colon (:) 
modifier (paragraph 3 . 16 . 2) . That is, rather than type out 
an error message if the command fails, the command returns 
a value of +1 if successful, if it fails. Even if the 
search fails, command execution within the command loop 
continues. Therefore Search commands within command loops 
should be written so as to provide a numeric argument to 
the next command or be used in conjunction with the semi- 
colon (;) command described in the following paragraph. 

3.13.2 Semicolon Command 

A semicolon (;) command can be used to prematurely terminate 
a command loop. The command transfers control out of the 
current command loop to the command immediately following the 
command loop if the last preceding Search command (S,C,N or Q) 
failed. Otherwise command execution within the command 
loop is continued. The semicolon (;) applies to the last 
previous search even though other commands may appear in the 
command string between the search command and the semicolon. 
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3.13.2 Semicolon Command (Continued) 
For example: 

^<CJUNE$JULY$;>T$$ This command string changes all 

occurrences of JUNE to JULY 
in the current buffer and types 

r-^n4- 4- V\ *^ -P -1 ■v- r^ 4- T -I * 
'w' LA t- »-lH= J_J.J_OU -L-Ll 

fer when through, 






_|_Y«StP; $;1KI J This command string removes 
5^R'>$$ the comment field from all 

pages of a source code file. 

Semicolon ( ; ) commands may only be used in command loops and 
are otherwise flagged as an error. 

The semicolon command can also be of the form: 
n; 

where: n is any numeric argument 

If n<0 then n; terminates the command loop. 
If n>0 the n; is disregarded. 

If a Search command in a command loop is not used as a 
numeric argum.ent to another command or followed by a semi- 
colon command, the n; command may be used as an alternate 
means of testing for an exit from the comm.and loop. Good 
SUPEREDIT programming practice would dictate that one of 
these techniques be used for determining the results of a 
Search command in a command loop. Otherwise, command 
interpretation may be incorrect. 

A colon (:) command modifier can be used with the semicolon 
(;) and n; commands. The form is: 

: ; or n: ; 

and reverses the action of the semicolon ( ; ) . That is, 
control is transferred out of the command loop if the last 
search was successful or n>0 . 
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3.14 NUMERIC VARIABLE COMMANDS 

The commands which alter the ten numeric integer variables 
(0 to 9) are described in Table 3-13. Each command returns 
a command value. Therefore, the commands may be used alone, 
in numeric expressions, or as numeric arguments to other 
commands . 

Table 3-13. Numeric Variable Commands 



Command 



Vv 
VI V 

VDv 

nVSv 



Description 



Represents the current value of variable v. 

Increments variable v and represents the 
incremented value. 

Decrements variable v and represents the 
decremented value. 

Sets variable v to value n and returns 
that value. 



Example: 



15VS1$V1+1T$$ 



Set variable 1 to 5 and type 
out 6 lines. 



3.15 FLOW CONTROL COMMANDS 

SUPEREDIT commands may be combined in a manner to provide 
unconditional branching to predefined labels and to provide 
branching based on the evaluation (true or false) of a 
number of branching conditions. These features permit the 
user to write SUPEREDIT "programs" to solve complex editing 
problems . 
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3.15.1 Command String Labels 

The facilitv used for narmn'^ l n'-'^-t--! --^-lo ''- -i-v-- v^ -, ^-^,, 

--' ^'•^'='-1 j-'-'-i- -laiaxuy xo^arxons wxtnxn a cormnana strinq 

IS the command string label which has the form: 
: label'. 



Label is a string delimited by a pair of exclamation point 
ci„„ ...„j ^^ j^j.ctv,ev^ diij/vviicxe xii ct comiridiiu String except m t 



string arauments 



s 
ext 



Labels are ignored unless specifically referenced by an 
unconditional branch command (paragraph 3.15.2). Therefore, 
they may also be used as comments throughout a SUPEREDIT 
pluyram. 

3.15.2 The Command 

The unconditional branch command is the command and is of 
the form: 

_;_01abel$ 

The command causes an unconditional branch to be performed to 
•label: in the command string and continues processing the 
command string from the first command immediately following 
.label I. The label must contain fewer than 48 characters and 
may not be within a command loop. 

However, an unconditional branch command may be used to exit 
from a command loop. 

3.15.3 Conditional Branching 

The general form of a conditional branch command is: 

n"xstring' 

where: n is a numeric argument 

X is one of the conditions (defined in Table 3-14) 
which is checked against the argument n, and 
string is a command string. 

If the condition is true, the commands until the next single 
quote (') are executed. If the condition is false, the 
commands before the next single quote (') are skipped and 
execution begins with the command which follows the sinale 
quote ( ' ) . ^ 
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3.15.3 Conditional Branching (Continued) 

Table 3-14. Conditional Branching Commands 



Conditional Branching Command (x) 



n"G 
n"L 
n"E 

n"N 



Meaning 


True if n > 




True if n < 




True if n = 




True if n 7^ 





Conditional Branching commands can be nested and can also 
contain or be contained within a command loop. If included 
within a command loop, the single quote (') associated with 
the double quote (") of the Conditional Branch command must 
be within the same command loop level. That is, when 
command loops are nested, a Conditional Branch command 
may not start at one command loop level and end at another. 



Acceptable 



'-erQT.na!^ ? DT.l T> 



Not Acceptable 



<SLDA$"N0L1T>' 



3.16 SPECIAL C0r4MANDS AND COMMAND MODIFIERS 



3.16.1 Special Commands 

There are several special commands available, 
mands are described in Table 3-15. 



These com- 
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3.16,1 Special Commands (Continued) 

Table 3-15. Special Commands 



Command 



Xstring$ 



n= 



-^n 



Description 



The Trace command. Used primarily for de- 
bugging complex SUPEREDIT macros. The first 
appearance of a "?" command in a command 

to print each command and its numeric argu- 
ments as it is executed. Subsequent "?" 
commands in the command string complement 
the trace mode flag thereby allowing the 
user to turn tracing on or off within a 
command string. 

Execute "string" as a CLI command. 
For example: 

^XDISK$$ 

R 

LEFT = 692. USED = 332 

- — __ __ 

Numeric typeout command. Causes the value 
of n to be printed on the terminal, n may 
be any numeric argument or expression. 

When used as the first command after a prompt, 
causes the previous command line to be 
placed in buffer n. This command is 
particularly useful for recovering from an 
inadvertant fA command (see section 2.12). 
If a ^n was intended as the first command 
but something else was typed, recovery may 
be accomplished by a fX or sufficient 
RUBOUTs to rubout the remainder of the line. 
If more than four characters had been typed, 
however, part of the old command line will 
be lost. 
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3.16.2 Command Modifiers 

There are two command modifiers which alter the normal 
interpretation of commands. The modifiers may be used 
individually or in combinations. The modifiers are described 
in Table 3-16. 

Table 3-16. Command Modifiers 



Command 
Modifer 



(colon) 



Description 



Used with Insert (I) and Search (S,C,N,Q) 
commands to change the command terminator 
from an ESC ($) to any other character. 
This modifier is particularly useful for 
inserting or searching for a single ESC ($) . 

NOTE 

A double ESC {$$) cannot be inserted 
using the @ modifier since it will 
terminate the command string. To 
search for a double ESC ($$) one must 
use the special control character "+•<-". 

When the @ modifier is used, the new command 
terminator is defined as the first character 
following the I, S, C, N or Q command. 



Examples : 



(ai/text/ 
(as%text% 
(aC3textl3text23 



/ is terminator 
% is terminator 
3 is terminator 



a) Can be used with any Search (S,C,N,Q) 

File Input (A,Y) and the R and nR Output 
commands to return a command value which 
then may be used as an argument to the 
next command. Command value is +1 if 
command was executed successfully; value 
is if execution was unsuccessful. No 
error message is typed out if command 
is unsuccessful. 
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3.16.2 Command Modifiers (Continued) 

Table 3-16. Command Modifiers (Continued) 



Command 
Modifier 



(colon) 



Desijriptxun 



a) (Continued) 
Example : 

^:5Stext$T$$ 



If search was not 
successful nothing 
is printed because 
the CP is at the 
beginning of the 
6th line following 
the current CP 
position. If search 
was successful, 
types balance of 
line following 
"text" (IT) . There- 
fore the success or 
failure of the search 
command provides a 
or +1 numeric argu- 
ment for the T com- 
mand. 



b) The colon (:) can be used with the Text 
Type-Out commands (see paragraph 3.4) 
to print the data on the line printer 
rather than the terminal. 

:0T, :nT, -:nT, and :m,nT are modified 
forms of the OT, nT, -nT, and m,nT 
commands respectively. 
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3.16.2 Command Modifiers (Continued) 

Table 3-16. Command Modifiers (Continued 



Command 
Modifier 



(colon) 



c) 



Description 



b) (Continued) 
Example : 



'.@:5S%text%:T$$ 



If search was not 
successful nothing 
is printed because 
the CP is at the 
beginning of the 
6th line following 
the current CP 
position. If search 

T.T^C7 c?n/-'r«oc: c: ■Fn 1 nTl nl" 

balance of line 

following "text" 

on line printer (1:T) 



Can also be used with semicolon ( ; ) and 
n; iteration commands (described in 
section 3.13) to reverse the action 
of the semicolon (;). That is, control 
is transferred out of the command loop 
if last search was successful of if n>0, 



d) Modifies the GWfilename$ command to 

create a randomly organized output file 
rather than a sequentially organized 
file. 



Example: 

1 :GWNETSAK.JR$$ 



Creates new ran- 
domly organized 
output file named 
NETS AK. JR. 
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3.16.2 Cominand Modifiers (Continued) 

Table 3-16. Command Modifiers (Continued) 



Command 
Modi f ier 



: (colon) 



Description 



(Continued 

e) Modifies the P, nP, -nP, OP, m,nP, PW, 
nPW, -nPW, OPW and m,nPW commands to 
clear the entire current buffer after 
output . 



Example : 

: :5,500P$$ 



Output the 6th through 
500th characters in 
the current buffer to 
output file with ap- 
pended form feed and 
delete the entire buf- 
fer. Equivalent to 
15,500P#K$$. 



3.17 CASE CONTROL COMMANDS 

The case control command, and its variations, are used to 
create and edit upper and lower case files from an upper 
case terminal. The command is of the form: 



where 



fn}WCfx}fy> 

n may be to deactivate case control, a positive 

value for up-shifting, or a negative value for 

dov/n-shifting. 

X is the shift character. 

y is the shift-lock character. 

Case control command variations are listed in Table 3-17. 
Examples and a discussion of the commands follow the table. 
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3.17 CASE CONTROL COMT^ANDS (Continued) 

Table 3-17. Case Control Commands 



Command 



WC 



OWC$$ 



nWCx$$ 



-nWCx$$ 



nWCxy$$ 
-nWCxy$$ 



Description 



Return value of case control mode. 

= deactivated 

1 = up-shifting 
-1 = down-shifting 

Deactivate case control. Characters are 
read from terminal exactly as typed without 
any translation. 

When n is positive, all characters are 
translated to lower case except when pre- 
ceded by shift character x which leaves 
the character upper case. 

When n is negative, all characters are 
left as upper case except when preceded 
by shift character x which translates 
the character to lower case. 

Same as nWCx$$ and -nWCx$$ except y is 
a shift-lock character which translates 
all characters following the shift-lock 
character (y) as all upper case (if 
shifting-up) or all lower case (if 
shifting-down) until next appearance of 
y or a double ESCape. 



Examples; 



11WC'$$ 



Set case control mode to shift- 
up. Use single quote as shift 
character. 



3-34 



3.17 CASE CONTROL COMMANDS (Continued) 
Examples: (Continued) 

|I'HELLO$0T$$ Insert "Hello" and type out 
'HELLO ! line. On typeout, the same 

shift character precedes any 
upper ca.se character so that 
output appears identical to 
input. 

If the user actually wanted to insert the shift character 
itself, he would precede it with another shift character 
which, in this situation, is a single quote. The two adjacent 
single quote characters would be treated as one. The same is 
true if the user wants to insert a shift-lock character, 
i.e., if preceded immediately by a shift character, the 
shift-lock character itself is inserted into the command 
string. 

^-1WC#$$ Set case control mode to shift- 

down. User number sign(#) as 
shift character. 

US#UPE#RED#I#T$$ Insert "SuPErEDit". 

^OWC$$ Deactivate case control. 

Case translation operates at the instant of type-in and type- 
out. Thus, if a "shifted" character is "rubbed out," the 
echo includes the shift character. If a user types a shift 
character preceding a character other than a letter or an- 
other shift character, shifting has no effect. It is as if 
the shift character were never typed. The only exception to 
this rule is the rubout character. Obviously, the rubout 
cannot be shifted so when a shift character precedes a 
rubout, the shift character itself is echoed and removed 
from the input stream. Shift-lock characters may not be 
rubbed out but can be nullified by typing a second shift- 
lock character. 

As a general rule, it is best to terminate all case control 
commands with a double ESC ($$) to avoid the possibility of 
confusion about when the command takes affect. 
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3.17 CASE CONTROL COMMANDS (Continued) 
Examples : 



_l_WC#$$ 
'.IABC##D#E#E 



Set case control mode to shift- 
up. 

User typed a rubout after 
number' sign(#) and after E. 



Once case control is active, it affects everything which is 
typed in, including WC commands. 



Examples : 



J_-1WC#$$ 
11WC##$$ 



_;_-iwc#$$ 

_1_0WC$$ 
UWC#$$ 

_^-iwc#$$ 

I1WC%$$ 



'.1WC'&$$ 



Changing modes with the same 
shift character requires a 
double shift character in 
order for the command to be 
properly interpreted. 

Deactivating before changing 
modes is an alternative to 
the preceding example. 

Changing modes and changing 
the shift character avoids 
confusion. 

Set shift-up mode using single 
quote as shift character and 
ampersand as shift-lock char- 
acter. 



_l_I'THE &NOVA& LINE COMPUTERS HAVE S,ALGOL&.$$ 

Insert "The NOVA line computers 
have ALGOL." 

J^OT$$ 

1 'THE 'N'O'V'A LINE COMPUTERS HAVE ' A' L' G' O' L . '. 
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CHAPTER 4 
IMPLEMENTATION NOTES AND EXAMPLES 



4.1 CORE UTILIZATION 

Initially, SUPEREDIT allocates lOK (decimal) of core. This 
allows room for approximately 14,000 characters for ECLIPSE 
line computers and 13,000 in the NOVA line computers. This 
space is divided, as needed, between the current edit buffer 
and the command input line buffer. If more room is needed, 
IK more core is obtained, and the message "**CORE**" is 
typed on the console. Each additional IK of core is enough 
storage space for 2K characters. 

When all available memory is exhausted, during command 
execution, SUPEREDIT types out — "MEMORY SPACE EXHAUSTED" 
and the current command is aborted. Enough room is left 
at this point to execute some commands, but an output com- 
mand should be executed shortly. 

If, when a command line is being typed in, available core 
space is exhausted, the error message "MEMORY SPACE EXHAUSTED" 
is typed out and a new prompt is issued. The old command 
line can be saved at this point by use of the "^n" command 
(see paragraph 3.16.1). 



4.2 ERROR HANDLING 

There are two classes of errors in SUPEREDIT - editor errors 
and RDOS errors. Editor errors are defined in Appendix C. 
There is a text file which contains the text of all these 
messages. If the file is present in the directory that 
SUPEREDIT is running in, errors are typed in the form 
"ERROR: text", where "text" is the message shown in the 
Appendix. If the text file is not present, the message 
"ERROR MESSAGE TEXT FILE NOT FOUND" is typed before the first 
prompt and editor errors are of the form "?nn" where nn is 
the error code shown in the Appendix. 



4-1 



4.2 ERROR HANDLING (Continued) 

RDOS errors are described in the RDOS User's Manual. If one 
of these occurs, "RDOS ERROR n" is typed, where n is the 
number of the error code. 

After any error, up to nine characters of the command line 
are typed, with the first character typed being the com- 
mand in error. The only exception to this occurs when the 
error is in a buffer or insert file being executed. In 
this case, the part of the command line typed will be the 
invocation of the file in error, e.g., if buffer A is being 
executed and an error occurs, what will be typed is "+BA". 

There is one other error that can occur, namely a fatal 
internal error. If this happens, a return will be made to 
the CLI , with the error code shown as the address of the 
command in error, thus causing the CLI to type "UNKNOWN 
ERROR CODE = XXXXX" , where XXXXX is the address of the 
error. This can only be caused by a malfunction in RDOS 
or SUPEREDIT. If this ever occurs, please save all details 
on how to recreate the error and notify your local DGC 
Applications Engineer. 



4 . 3 RDOS CHANNEL USAGE 

The editor is initially built with eight RDOS I/O channels, 
This is sufficient for most normal editing functions. 
However, complex editing may require more channels. (With 
3 6 buffers, SUPEREDIT has the potential to use more than 
the RDOS limit of 64 channels, since it needs one channel 

SUPEREDIT runs out of channels, error code 21 (NO MORE 
CHANNELS) is output. The number of channels can be 
changed by modifying location 413g in the save file using 
CEDIT (see OEDIT User's Manual, 093-000084). The right 
byte in this word contains the number of channels which 
are initialized for the editor. 
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4.4 CHANGING THE ESCAPE CHARACTER 

SUPEREDIT uses the ASCII ESC character (octal 33) as its 
escape character. Older model teletypewriters may generate 
another code from the ESC (or ALT MODE) key. In order to 
use SUPEREDIT from such a terminal, the user must chanae 
location 458 in the save file using OEDIT (see OEDIT User's 
Manual, 093-000084) so that it contains the octal code for 
the character to be used as the escape character. 



4 . 5 EXAMPLES 

The following examples are provided to illustrate the use 
of as many SUPEREDIT commands as possible. As such, the 
examples do not necessarily represent the most efficient 
method of solving the stated problems. In addition, some 
problems are done by two methods to further illustrate the 
use of SUPEREDIT commands. 
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4.5 EXAMPLES (Continued) 

Example 1 ; Change file containing random size pages to 

one which contains 5 line pages (Method A) , 



_;_50W$UYfilename$«StL$;-lD>ZJIfL$R;>US$$ 

Explanation of Example 1: 

;50W$ Set window mode - 50 lines long. 

UYfilename$$ Open "filename" for input and output. 

Yank 50 lines . 

«S+L$;-1D> Search buffer for all occurences of +L 

(form feed) and delete. 
Exit inner command loop when search fails. 

2;,ji-tL$ Position the CP at end of buffer and insert 

a form feed. 

R;> Output buffer to output file. Yank another 

50 lines and repeat outer loop. If R fails 
exit loop. 

US$$ Close 1/0 files with back-up. 

Although "Z" is a character oriented argument and "J" is 
a line oriented command, use of the "ZJ" combination is 
acceotable and provides a useful technique for positioning 
the CP at the end of the buffer. The combinations "ZM" 
and "VN+IJ" will also position the CP at the end of the 
buffer. 
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4.5 EXAMPLES (Continued) 



Example 2 ; Change file containing random size pages to 

one which contains 50 line pages (Method B) , 

j^SOV'wuYf ilenairie$BSl$12l$BS0$ 
«S + Bl$;-lD>ZJIfBl$R;>US$$ 



J.50W$ Set window mode - 50 lines long 

UYfilename$ Open "filename" for input and output. 

Yank 50 lines. 

BS1$12I$BS0$ Put the ASCII decimal representation of 

form feed in edit buffer 1 and return to 
edit buffer 0. 

«S + B1$;-1D> Search edit buffer for all occurences of 

the contents of edit buffer 1 (form feed 
character) and delete. Exit inner command 
loop when search fails. 

ZJIfBl$ Position the CP at end of buffer and insert 

form feed character from buffer 1. 

^'> Output buffer to output file. Yank another 

50 lines and repeat outer loop. If R fails, 
exit loop. 

US$$ Close I/O files with back-up. 
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4.5 EXAMPLES 
Example 3: 



(Continued) 

Put consecutive page numbers at the top 
of each page in file (Method A) . 



lUYfilename$ 

0VS00VS10VS2 

: PAGE : 7<i I $>IPAGEA $ 

VIO-10"EOVSOVI1-10"EOVS1VI2' ' 

48+V2I48+V1I4 8+V0II) 

$:R"NOPAGE$'US$$ 



Explanation of Example 3 
UYfilename 



0VS00VS10VS2 

1 PAGE '. 7<+ 1 $>IPAGEA $ 
VI0-10"E 

0VS0VI1-10"E 



0VS1VI2' 



4 8+V2I48+V1I4 8+V0II) 



$:R"NOPAGE$'US$$ 



Open "filename" for input and output. 
Yank first page. 

Set units, tens and hundreds counter 
to zero. 

Insert seven tabs and insert "PAGEA". 

Increment units counter and subtract 
10. If not equal to skip commands 
to matching apostraphe ( ' ) . 

If units counter reached 10, zero the 
units counter, increment the tens 
counter and subtract 10. If not equal 
to zero skip commands to matching 
apostrophe ( ' ) • 

If tens counter reached ten, zero the 
tens counter and increment the 
hundreds counter. 

Insert the ASCII decimal equivalent of 
the integers stored in the hundreds, 
tens, and units counters followed by 
a carriage return. 

Output page and yank another page. If 
yank was successful jump to location 
PAGE in macro. Otherwise close I/O 
files with back-up. 
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4.5 EXAMPLES (Continued) 

Example 4 ; Put consecutive page numbers at the top of 

each page in file (Method B) . 

^UYfilename$0VS0$<7<-M$>IPAGEA$VI0\$R;>US$S 

Explanation of Example 4: 

_l_UYfilename$ Open "filename" for input and output. 

Yank a page. 

OVSO$ Set variable to . 

<7<'M$>IPAGEA$ Space over seven tabs and insert "PAGEA". 

VIO\$ Increment variable 0, convert integer to 

decimal ASCII representation and insert. 

^''> Output page to output file and yank another 

page. If yank is successful, repeat loop. 
Otherwise, exit loop. 

US$$ Close I/O files with back-up. 
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4.5 EXAMPLES (Continued) 



Example 5 



Create file (FILE. 3) comprised of rearranged 
pages from two other files (FILE.l and FILE. 2) 



FILE.l 



FILE. 2 



Page 


1 


Page 


2 


Page 


3 



Page 


1 


Page 


2 


Page 


3 



FILE. 


3 


FILE. 
Page 


1 
3 


FILE 
Page 


1 
2 


FILE 
Page 


2 
3 


FILE 
Page 


.1 

1 


FILE 
Page 


,2 

1 


FILE 
Page 


.2 
2 



^GWF I LE . 3 $GRF I LE . 1 $ 3< Y>P $ 

GRFILE.1$2<Y>P$GRFILE.2$3<Y>P$ 

GRFILE.1$YPGRFILE.2$YRP$GR$GC$$ 

Explanation of Example 5: 

_I_GWFILE.3$ Create new output file FILE. 3. 

GRFILE.1$3<Y>P$ Open FILE.l for input, get the third page 

and output to FILE. 3. 

GRFILE.1$2<Y>P$ Close and reopen FILE.l, get second page 

and output to FILE. 3. 

GRFILE.2$3<Y>P$ Close FILE.l and open FILE. 2 for input. Get 

third page and output to FILE. 3. 



GRFILE.1$YP 

GRFILE.2$ 
YRP$ 

GR$GC$$ 



Close FILE. 2 and open FILE.l for input. Yank 
and output first page to FILE. 3 

Close FILE.l and open FILE. 2 for input. 

Yank first page and output. Yank second page 
and output 

Close FILE. 2 and FILE. 3. 
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4.5 EXAMPLES (Continued) 



Example 6: Create macro of Example 4 in a buffer which 

can be called for reuse by a fBx command. 

iBSl$(ai%0VS0$<7<+I$>IPAGEA$VI0\$R;>US%BS0$$ 
_I_UYf ilename$thil$$ 



Explanation of Example 6: 

j_BSl$@i%. . .% Make buffer 1 current and insert 

command string delimited by "%" 
character. 

^^0$$ Return to buffer 0. 

lUYfilename$fBl$$ Open "filename" for input and output 

and execute macro in buffer 1. I/O 
files are closed by macro. This com- 
mand line may be repeated for any 
"filename" without the need for 
entirely retyping the macro contained 
in buffer 1. 
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4.5 EXAMPLES (Continued) 

Example 7: Create macro of Example 4 in a file which 

can be called for reuse by a 'hGfilename$ 
command. The file can be saved for use 
in subsequent editing sessions. 

_1_GWMACRO.1$@I%0VS0$<7< + I$>IPAGEA$VI0n$R;>US%PWUE$$ 
|^UYfilename$ + GMACR0.1$$ 

Explanation of Example i : 

1GWMACR0.1$ Open file MACRO. 1 for output. 

(ai%...% Insert command string delimited by "%". 

PWUE$$ Write content of buffer to output file 

and close file. Use PW to avoid form 
feed which would be interpreted as an 
erroneous command in the file. 

•.UYfilename$ + GMACR0.1$$ Open "filename" for input and output 

and execute commands in file MACRO. 1. 
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APPENDIX 


A 








ASCII CHARACTER SET 




CHARACTER 




OCTAL 




DECIMAL 


UTTT-r f 

1.NU±j1j 




000 







+ A 




001 




1 


fB 




002 




2 


+c 




003 




3 


fD 




004 




4 


+ E 




005 




5 


fF 




006 




6 


tG 




007 




7 


+ H 




010 




8 


TAB ( f I ) 




oil 




9 


LINE FEED 


(tJ) 


012 




10 


VERT . TAB 


( + K) 


013 




11 


FORM FEED 


(tL) 


014 




12 


CARRIAGE 










RETURN (fM) 


015 




13 


+ N 




016 




14 


fO 




017 




15 


tP 




020 




16 



A-1 



CHARACTER 




OCTAL 


DECIMAL 


+ Q 




021 


17 


+ R 




022 


18 


iS 




023 


19 


+ T 




024 


20 


fU 




025 


21 


+ V 




026 


22 


fW 




027 


23 


fX 




030 


24 


+ Y 




031 


25 


+ z 




032 


26 


ESC or ALT MODE 
or CTRL-SHIFT-K 


033 


27 


CTRL-SHIFT- 


-L 


034 


28 


CTRL-SHIFT- 


-M 


035 


29 


CTRL-SHIFT- 


-N 


036 


30 


CTRL-SHIFT- 


-0 


037 


31 


SPACE 




040 


32 


1 

« 




041 


33 


II 




042 


34 


# 




043 


35 


$ 




044 


36 


% 




045 


37 


& 




046 


38 
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CHARACTER 


OCTAL 


DECIMAL 


' (apostrophe) 


047 


39 


( 


050 


40 


) 


051 


41 


* 


052 


42 


+ 


053 


43 


7 ;. \_ \yiiLLl.lCl J 


r\ 1- A 
U J <* 


44 


- (I'iiniis) 


055 


45 


■ 


056 


46 


/ 


057 


47 





060 


48 


1 


061 


49 


2 


062 


50 


3 


063 


51 


4 


064 


52 


5 


065 


53 


6 


066 


54 


7 


067 


55 


8 


070 


56 


9 


071 


57 


: 


072 


58 


/ 


073 


59 


< 


074 


60 



A- ?. 



CHARACTER OCTAL DECIMAL 



075 61 

> 076 62 

? 077 63 

@ 100 64 

A 101 65 

B 102 66 

C 103 67 

D 104 68 

E 105 69 

F 106 70 

G 107 71 

H 110 72 

I 111 73 

J 112 74 

K 113 75 

L 114 76 

M 115 77 

N 116 78 

117 79 

P 120 80 

Q 121 81 

R 122 82 
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CHARACTER OCTAL DECIMAL 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 



s 


123 


T 


124 


U 


125 


V 


126 


W 


127 


X 


130 


Y 


131 


Z 


132 


- 


133 


\ (SHIFT-L) 


134 


] 


135 


i- 


136 


^ or 


137 


- 


140 


a 


141 


b 


142 


c 


143 


d 


144 


e 


145 


f 


146 


g 


147 


h 


150 
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CHARACTER 


OCTAL 


DECIMAL 


i 


151 


105 


J 


152 


106 


k 


153 


107 


1 


154 


108 


in 


155 


109 


n 


156 


110 


o 


157 


111 


P 


160 


112 


q 


161 


113 


r 


162 


114 


s 


163 


115 


t 


164 


116 


u 


165 


117 


V 


166 


118 


w 


167 


119 


X 


170 


120 


Y 


171 


121 


z 


172 


122 


{ 


173 


123 


1 


174 


124 


} 


175 


125 


~ (tilde) 


176 


126 


RUBOUT or 
DELETE 


177 


127 
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APPENDIX B 
SUPEREDIT COMMAND SURMJ^^RY 



B.l FILE SPECIFICATION COMMANDS 



Command 



Description 



Page 
Reference 



r*T.-r^.: -i ^ 



:GWfilename$ 

CCS 

UY filenames 

GRf ilename$ 

GR$ 
US $ 



UE$ 



U?$ 



create ana open a new output 
file in sequentially organized 
format. 



Create and open a new output 
file in randomly organized 
format . 

Close current output file. 

Open filename for input, 
filename. SC for output 
and Yank (Y) a page. 

Close current input file and 
open filename for input. 

Close current input file. 

Transfer remainder of input 
file to output file. Close 
input/output files. If 
opened by UY command, create 
back-up . 

Transfer remainder of input 
file to output file. Close 
input/output files. If 
opened by UY command, delete 
input file and rename out- 
put to input filename. 

Type global and local file 
status . 



3-1 

3-2 
3-2 

3-2 

3-3 
3-3 



3-3 



3-4 



3-5 



B-1 



B.2 PAGE AND WINDOW MODE COMMANDS 

Page 
Coimnand Description Reference 



WM Return value of data input 

mode . (0 or n) . 3-5 

nWM Change from Page to Window 

Mode with n line window 
length. 3-5 

0V7M Change from Window to Page Mode. 3-5 



B.3 INPUT COMJ^>IANDS 

Page 
Command Description Reference 



' Clear buffer and read one 

page from input file. 3-6 

L Read one page from input file 

and append to current edit 
buffer. 3-6 

;Y and :A Same as Y and A respectively 

except command returns a 
value of +1 if it succeeds 
and if it j-ails xnsteau 
of an error message. 3-6 
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B.4 TEXT TYPE-OUT COMMANDS 
Command Description 



T 



OT 



Tvnpi r'nr--rcin+- 1 t i-v/-, <- 1- ^r t -■' », „ 

position of CP. 



nT 



■nT 



B.5 CHARACTER POINTER C0]\ir4ANDS 
Command Description 



Page 
Reference 



^-7 



Type from beginning of cur- 
rent line to position of CP . 3-7 

Type from CP through next 

n carriage returns. 3-7 

Type n lines preceding cur- 
rent line plus characters 
on current line up to CP . 3-7 

"^''^'^ Type the m+lth through nth 

characters inclusive. 3-7 

:0T^ :nT, Sam.e as OT, nT, -nT, and 

:-nT, :m,nT m,nT except output to line 

printer instead of terminal. 3-7 



Page 
Reference 



""^ Move CP to beginning of line n. 3-8 

"^ °^ OJ Move CP to beginning of buffer. 3-S 

'^L Move CP to beginning of line 

following the nth carriage 
return. 3..." 

~^^-' Move CP to beginning of nth 

line preceding current line. :i-U 

^' °^ OL Move CP to beginning of current 

line. 3_e 

^^'^ Move CP across n characters. 3-8 
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B.6 SEARCH COMMANDS AND CONTROL CHARACTERS IN SEARCHES 



Command 



Description 



Page 
Reference 



Stext$ 

nStext$ 
-nStext$ 

OStext$ 

TTi . nStext $ 
Ntext$ 

Otext$ 

Ctextl$text2$ 

nCtextl$text2$ 

-nCtextl$text2$ 
0Ctextl$text2$ 



Starting at CP search for text 
delimited by S and ESC($) in 
current buffer. 

Search from CP through next n 
carriage returns for text. 

Search preceding n lines plus 
characters up to CP on current 
line for text. 

Search current line from be- 
ginning of line up to CP for 
text. 

Search m+lth through nth 
characters for text. 

Search rest of input file for 
text. Output buffer to output 
file for each page until text 
is found. 

Same as Ntext$ except buffer 
is not output. 

Search for textl and replace 
with text2. 

Search from CP through next n 
carriage returns for textl and 
replace with text2. 

Search preceding n lines plus 
characters up to CP on current 
line for textl and replace 
with text2. 

Search current line from be- 
ginning of line up to CP for 
textl and replace with text2. 



3-9 



3-9 



3-9 



3-10 



3-10 



3-11 



3-11 



j-iu 



3-10 



3-10 



3-11 
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B.6 SEARCH COi'lMANDS AND CONTROL CHARACTERS IN SEARCHES (Continued) 

Page 
Coininand Description Reference 

iTi, nCtextx $text 2 $ Searcn iu+j.th through nth 

characters for text! and 
replace with text2. 3-11 

(as%text% Same as Stext$ except text 

delimited by first character 
after S (arbitrarily shown as 
"%"). Other variations are: 

(anS%text% 

(?-nS%text% 

flOS%text% 

@m,nS%text% 

§N%text% 

@Q%text% 

@C%textl%text2% 

'anC%textl%text2% 

@-nC%textl%text2% 

ia0C%textl%text2% 

(am,nC%textl%text2% 3-12 

iStextS Same as Stext$ except command 

returns a value of +1 if it 
succeeds and if it fails 
instead of an error message. 
Other variations are: 

:nStext$ 

: -nStext$ 

:OStext$ 

:m,nStext$ 

:Ntext$ 

:Qtext$ 

:Ctextl$text2$ 

:nCtextl$text2$ 

:-nCtextl$text2$ 

:0Ctextl$text2$ 

:m,nCtextl$text2$ 3-12 



B.6 SEARCH COr-tMAND AND CONTROL CHARACTERS IN SEARCHES (Continued) 

Page 
Command Description Reference 



@:S%text% Combines the @ and : modifiers 

described above. Other 
variations are: 

§:nS%text% 

@:-nS%text% 

^OS%text% 

§:m,nS%text% 

@:N%text% 

@:Q%text% 

@:C%textl%text2% 

(a:nC%textl%text2% 

(? : -nC%textl%text2% 

(a:0C%textl%text2% 

(a:m,nC%textl%text2% 3-12 

tz Accept any character in 

this position. 3-13 

-^Nx Accept any character except 

X in this position. 3-13 

'^Vx Accept any number of the 

character x in this position. 3-13 

t-<- Intrepret next character 

literally, rather than as a 

special character. 3-13 

fP Position CP at location of tP 

in search string if search is 
successful. 3-14 

tT Accept any number of spaces 

or tabs in this position. 3-14 
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B.7 INSERTION C0MJ4ANDS 



Command 



Itext$ 



fItextS 



nl 



n\ 



@I%text% 
@+I%text^ 



Description 

Insert text delimited by I 
and ESC{$) at the current 
position of the CP . 

Insert tab plus text de- 
limited by fl and ESC(§). 

decimal equivalent (from 
Appendix A) is n. 

Insert ASCII representation 
of the decimal number n into 
the buffer at the CP location. 

Same as Itext$ and 'Htext% 
respectively except inserted 
text is delimited by first 
character after I (arbitrarily 
shown as "%" ) . 



Page 
Reference 



3-15 



3-15 



3-15 



3-15 



3-15 



B.8 DELETION COMMANDS 



Command 



nD 



nK 



-nK 



m,nK 



Description 

Delete n characters starting 
at CP position. 

Delete characters starting at 
CP position through n 
carriage returns. 

Delete preceding n lines and 
characters up to the CP on 
the current line. 

Delete the m+lth through 
nth characters inclusive. 



Page 
Reference 



3-16 



3-16 



3-16 



3-16 



K or OK 



Delete characters starting at 
CP position back to beginning 
of line. 



3-16 
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B.9 OUTPUT COMMANDS 
Command 



PW 



•nPW 



OPW 



Page 
Description Reference 



P Output edit buffer with 

appended form feed to output 

file. 3-17 

np Output n lines from CP to 

output file with appended 
form feed. 3-17 

_nP Output preceding n lines plus 

characters up to the CP on 
current line to output file 
with appended form feed. 3-17 

OP Output current line from be- 

ginning of line up to the CP 
to oxitput file with appended 
form feed. -^ -^ ' 

i^^nP Output m+lth through nth 

characters inclusive to 
output file with appended 
form feed. 3-17 



Output edit buffer to output 

file. 3-17 



nPW Output n lines trom Cir- to 

output file. 3-17 



Output preceding n lines plus 

characters up to the CP on 

current line to output file. 3-17 



Output current line from 

beginning of line up to the CP 

to output file. 3-18 



m,nPW Output m+lth through nth char- 

acters inclusive to output file. 3-18 
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B.9 OUTPUT COMMANDS (Continued) 
Coininand Description 



R 



Page 
Reference 



Output edit buffer, clear 

buffer, and yank next page 

from input file. 3-18 



3-18 



"^ Repeat R command n times. 

--- — .„ ...^. L^auic ctt> K ana nK except 

command returns a value of 

+1 if it succeeds and if 

it fails instead of an error 

message. 3-18 

'^ Same as P except buffer cleared 

after output. Other variations 
are: 

:nP 

:-nP 

:0P 

:m,nP 

:PW 

:nPW 

: -nPW 

:OPW 

:m,nPW 

E Output buffer and rest of input 

file. 3_3^8 

B.IO EXIT COMMANDS 

Command Description Reference 

H Normal exit from SUPEREDIT. 

Returns user to the CLI . 3-19 

^^ Emergency exit from SUPEREDIT. 

System break command returns 
user to the CLI. 3-19 
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B.ll BUFFER COMMANDS 

Page 
Command Description Reference 

BSx Change current buffer to 

buffer X. 3-20 

B?$ Type out buffer status for 

all active buffers. 3-20 

B?x$ Type out status of buffer x. 3-20 

BCx Copy entire content from cur- 

rent buffer to buffer x. 3-20 

nBCx Copy the next n lines from CP 

position in current buffer to 
buffer X. 3-20 

-nBCx Copy the preceding n lines plus 

the characters up to the CP in 
the current line to buffer x. 3-20 

m,nBCx Copy the m+lth through nth char- 

acters inclusive from current 
buffer to buffer x. 3-20 

BTx, nBTx, -nBTx, Same as BCx, nBCx, -nBCx and 
m,nBTx m,nBCx respectively except char- 

acters moved from current buf- 
fer are deleted. 3-20 



BKx 



Delete buffer x. 3-20 



BCx {filename} $ Execute a Gx command (where Gx- 

GR, GW or GC) local to the cur- 
rent buffer. 3-21 

BUx {filename]- $ Execute a Ux command (where Ux= 

UY, UE or US) local to the cur- 
rent buffer. 3-21 

BAx Activate buffer x. 3-21 
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B.12 COMMAND STRING INSERTION COJ^IMANDS 



Command 



fGfilename 



fBx 



Description 

Inserts contents of file 
filename into command 

-l-Gfilename command. 

Inserts content of buffer 
X into command strin" in 
place of fBx command. 



Page 
Reference 



3-23 



3-23 



B.13 ITERATION COMMANDS 



Command 



Description 



Page 
Reference 



n<coramand string> 



Perform enclosed commands n 
times. If n < skip 
command loop . 

Jump out of command loop if 
last Search command 
failed. 
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"J-T; 



n; 



n: ; 



Jump out of command loop 
if n < 0. 

Jump out of command loop if 
last Search command was 
successful. 

Jump out of command loop if 
n >0. 



3-25 

3-25 
3-25 
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B.14 NUMERIC VARIABLES AND SPECIAL CHARACTERS 



Command 



Vv 



VIv 



VDv 



nVSv 



(Period) 



VN 



VL 



Description 

Represents the current value 
of variable v. 

Increments the value of 
variable v and represents 
the incremented value. 

Decrements the value of 
variable v and represents 
the decremented value. 

Set variable v to value n and 
return that value. 

Represents the total number of 
characters in the current 
buffer. 

Represents the current CP 
position. 

Equivalent to double argument 
0,Z (entire edit buffer). 

Represents the number of lines 
in current buffer. 



Repreaenta the xiujuber Oj- tue 



line which contains the CP . 
B.15 FLOW CONTROL COMMANDS 



Command 



Description 



Define a label named "string" 
in the command string. 



I string I 
Ostring$ 
n"Gcommand string' Execute command string if 



Transfer control to label 
"string" . 



Page 
Reference 



3-26 



3-26 



3-26 



3-26 



2-7 



2-7 



2-7 



2-7 



2-7 



Page 
Reference 



3-27 



n > 0, 



3-27 



3-27 
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B.15 FLOW CONTROL COMMANDS (Continued) 



Command 



Description 



n"Lcommand string' Execute command string if 

n > 0. 

n"Ecommanu string* Execute command string if 

n = 0. 

n"Ncommand string' Execute command string if 

V, 3/ n 

>■>■ r u . 



Page 
Reference 



3-27 
3-27 
3-27 



B.16 SPECIAL COMMANDS AND COMMAND MODIFIERS 



Command 



Xstring$ 



n= 



(3 



Description 

Complement trace mode flag. 

Execute "string" as a CLI 
command . 

Type out value of numeric 
argument n. 

Place previous command string 
in buffer n. (Must be first 
command after prompt) . 

Modify Insert and Search com- 
mands to change text delimiter. 

Modify Search and File Input com- 
mands (A,Y,R,S,N,Q,C) to return 
value of if Search or Input 
fails; +1 is successful. 

Modify Type commands (nT,-nT, 
m,nT) to output to line printer. 

Modify Output commands (P,nP,m,nP, 
PW,nPW,m,nPW) to clear buffer 
after output. 

Modify GWfilename$ command to 
create randomly organized output 
file. 

B-13 



Page 
Reference 

3-29 



3-29 
3-29 

3-29 
3-30 



3-30 



B.17 CASE CONTROL C0r4MANDS 



Command 



Description 



Page 
Reference 



WC 

OWC$$ 
nWCx$$ 

-nWCx$$ 

nWCxy$$ 

-nWCxy$$ 



Return value representing 
case control mode 
(0, 1, or -1) . 

Deactivate case control. 

When n is positive shift- 
up using x as shift 
character. 

When n is negative, shift- 
down using x as shift 
character. 

When n is positive, shift- 
up using x as shift 
character and y. ^^ shift- 
lock character. 

When n is negative shift- 
down using x as shift 
character and y as shift- 
lock character . 



3-33 
3-33 

3-33 

3-33 



3-33 



3-33 
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APPENDIX C 
SUPEREDIT ERROR MESSAGES 



Error 


Error 


Number 


Message 


1 


ILLEGAL FILE NAME 


2 


SYNTAX ERROR 


3 


ILLEGAL VARIABLE 




NAME 



10 

11 

12 
13 



ILLEGAL NUMBER OF 
ARGUMENTS TO COMMAND 

ILLEGAL BUFFER NAME 



BUFFER IS INACTIVE 



MAXIMUM ITERATION 
LEVEL EXCEEDED 

NO OPEN FILE 



FILE ALREADY EXISTS 
FILE DOES NOT EXISTS 
FILE ALREADY OPEN 



Explanation 



Format of command incorrect 
(e.g., 2#T) . 

Legal variable names are 
through 9 only. 

Commands such as m,nR are 
not legal. 

A through Z and through 9 
are the only legal buffer 
names . 

An attempt to BKx or fBx 

an inactive or empty buffer. 

Command loop nesting level 
is greater than 10. 

Attempt to use A, Y, P, PW, 
E, R, UE, or US command with- 
out an open file. 



Attempt to open an output file 
with a GW or UY command with- 
out first closing a previously 
opened output file. 
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Error 
Number 

14 



15 
16 

17 



20 



21 



22 



23 



24 



Error 
Message 

NO MORE CHARACTERS 
IN INPUT FILE 

UNSUCCESSFUL SEARCH 

MAXIMUM INSERT 
DEPTH EXCEEDED 

SEARCH STRING OR <> 
BROKEN OVER TWO 
LEVELS 



INSERT FILE TOO 
LONG 

NO MORE CHANNELS 
AVAILABLE 

INPUT LINE TOO LONG 



ATTEMPT TO DELETE 
CURRENT BUFFER 

PARITY ERROR 



Explanation 

End of file reached by an 
A, Y, or R coiranand. 



Nesting level of tBx and 
fGfilename? command exceeded, 

Search command or command 
loop starts at one command 
insert level and ends at 
another level. 

File larger than 16K 
bytes. 

All I/O channels in use. 
See section 4.3. 

Maximum line length is 132 
characters. A line longer 
than 132 characters read by 
an A, Y, R, or E command. 
Warning message only; execu- 
tion of the command string 
continues. 

A BKx command may not be 
used for the current buffer. 

The character in error is 
replaced by a backslash (\) . 
Warning message only; execu- 
tion of the command string 
continues . 



25 STACK OVERFLOW 

26 MEMORY SPACE 
EXHAUSTED 

27 ATTEMPT TO EXECUTE 
CURRENT BUFFER 



No more core available. 
See section 4.1. 

A fBx command may not be 
used for current buffer. 
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Error Error 
Number Message 

30 UNTERMINATED STRING 



31 < WITH NO CORRESPOND- 
ING > 

32 " WITH NO CORRESPOND- 
ING • 

3 3 LABEL NOT FOUND 



34 UNABLE TO OPEN $LPT 

35 STRING ARGUMENT 
TOO LONG 

3 6 FIRST ARGUMENT 

GREATER THAN SECOND 
ARGUMENT 



40 RENAT^ING ERROR 

41 ILLEGAL COMf-IAND 



42 ILLEGAL ARGUMENT 
TO COMMAND 



43 ILLEGAL CONTROL 
CHARACTER IN 
SEARCH STRING 



44 FILE READ PROTECTED 

45 FILE WRITE PROTECTED 

53 DIRECTORY SPECIFIER 
UNKNOWN 



Explanation 

@S or @I command without 
second delimiter. 



±j3.ijBj. rei.ercntjfcid by uncondi- 
tional jump (0) command 
not found . 



In Ostring$ command, string 
is > 48 characters. 

In commands which have two 
arguments, the first must 
be less than or equal to 
the second (e.g., m,nT) . 



A character or characters 

were used which are not defined 

as a legal SUPEREDIT command. 

Command which only accepts a 
positive argument was given 
a negative argument. 

A character other than those 
described in paragraph 3.6.2 
appeared in a search command 
argument . 
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Softw«re OfKiinwntatibfi Semafk* f omi 



MM X» yoatUt^rTMrMantiattf 
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rr^ 



I II I, 1. umii ■ 



Title. 



We wrote the book for you, and naturally we had to make certain assumptions about who you are and how you 
would use It. Your comments will help us correct our assumptions and improve our manuals Please take a few 
minutes to respond. c a icw 

If you have any comments on the software itself, please contact your Data General representative If you wish to 
order manuals, consult the Publications Catalog (01 2-330). 



on? 



n EDP Manager 

D Senior System Analyst 

n Analyst/Programmer 

Q Operator 

n nthor 



What programming language(s) do you use? 



How Do You Use This Manual? 

(List in order: I = Primary use) 

Introduction to the product 

Reference 

Tutorial Text 

Operating Guide 



^ i^ijtey'Hieivtanaayr: 



'f^tt-n.' M '.p.^4^>j^<^.|.4^.i vi if»--.-^ ».^ 



Yes Somewhat No 

D n □ Is the manual easy to read? 

n D n Is it easy to understand? 

n n n is the topic order easy to follow? 

I— ' lJ n Is the technical information accurate? 

L] I— I n Can you easily find what you want? 

U d D Do the illustrations help you? 

□ n D Does the manual tell you everything you need to know'' 

(Please note page number and paragraph M.here applicable ) 
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